home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 23 / AACD 23.iso / AACD / Programming / tek / INSTALL < prev    next >
Text File  |  2001-05-12  |  6KB  |  194 lines
  1.  
  2. TEKlib platform builds
  3. =============================================================
  4.  
  5. note: many programs in the examples directory will try to
  6. open a window, so one of the 'visual' builds is required for
  7. them to compile.
  8.  
  9.  
  10. Linux/32bit, gcc
  11. -------------------------------------------------------------
  12.  
  13.     1 enter tek/
  14.  
  15.     2 copy type_linux32.h over type.h
  16.  
  17.     3 build
  18.  
  19.       - link library, no visuals, with stderr debugging:
  20.         > make -f build/linux/Makefile_linux teklib
  21.  
  22.       - link library, no visuals, built from a single file,
  23.         maximum inlining and optimization:
  24.         > make -f build/linux/Makefile_linux teklibmonster
  25.  
  26.       - link library including visuals, with stderr debugging:
  27.         > make -f build/linux/Makefile_linux teklibvisual
  28.  
  29.       - link library including visuals, built from a single file,
  30.         maximum inlining and optimization:
  31.         > make -f build/linux/Makefile_linux teklibvisualmonster
  32.  
  33.     4 build examples with libtek.a. the include directory is
  34.       the parent of tek/. link with -lpthread, and with -lX11 where
  35.       required. for instance
  36.       
  37.       > cd examples
  38.       > gcc example.c ../libtek.a -o example -I ../../ -lm
  39.         -lpthread -lX11 -L /usr/X11R6/lib
  40.  
  41.       or use Makefile_linux in the examples directory.
  42.  
  43.     5 if you want to install the header files and link library:
  44.     
  45.       > mkdir /usr/local/include/tek
  46.       > cp tek/*.h /usr/local/include/tek
  47.       > cp tek/libtek.a /usr/local/lib
  48.  
  49.  
  50. AmigaOS 3.x, SAS/C 6.5x
  51. -------------------------------------------------------------
  52.  
  53.     1 enter tek/
  54.  
  55.     2 copy type_amiga.h over type.h
  56.  
  57.     3 build
  58.     
  59.       - link library, no visuals, with kprintf debugging:
  60.         > smake -f build/amiga/Makefile_amiga_sasc teklib
  61.     
  62.       - link library, no visuals, built from a single file,
  63.         no debug, maximum optimization and inlining:
  64.         > smake -f build/amiga/Makefile_amiga_sasc teklibmonster
  65.  
  66.       - link library including visuals, with kprintf debugging:
  67.         > smake -f build/amiga/Makefile_amiga_sasc teklibvisual
  68.  
  69.       - link library including visuals, built from a single file,
  70.         maximum inlining and optimization, no debug:
  71.         > smake -f build/amiga/Makefile_amiga_sasc teklibvisualmonster
  72.  
  73.     4 link examples with tek.lib. include directory is the
  74.       parent directory of tek/. or enter the examples directory
  75.       and issue
  76.       
  77.       > smake -f Makefile_amiga_sasc all
  78.       
  79.     5 if you want to install the header files and link library:
  80.     
  81.       > makedir INCLUDE:tek
  82.       > copy tek/#?.h INCLUDE:tek
  83.       > copy tek/tek.lib LIB:
  84.  
  85.  
  86. TAO Elate/AmigaSDK 1.01, vpcc
  87. -------------------------------------------------------------
  88.  
  89.     1 make sure the source tree is located in /lib/tek, so
  90.       that the library is built at its designated place in
  91.       the filesystem. there is no installation required.
  92.     
  93.     2 enter /lib/tek
  94.  
  95.     3 copy type_elate.h over type.h
  96.  
  97.     4 build
  98.     
  99.       - tool library, no visuals:
  100.         > make -f build/elate/Makefile_elate teklib
  101.  
  102.       - tool library, including visuals:
  103.         > make -f build/elate/Makefile_elate teklibvisual
  104.  
  105.     5 build examples with -I /lib/, for instance
  106.     
  107.       > cd examples
  108.       > vpcc example.c -o example -I /lib/
  109.       
  110.       or use Makefile_elate in the examples directory.
  111.       
  112.     6 if you want to install the header files:
  113.     
  114.       > mkdir /lang/cc/include/tek
  115.       > cp tek/*.h /lang/cc/include/tek
  116.  
  117.  
  118. MorphOS, gcc
  119. -------------------------------------------------------------
  120.  
  121.     1 enter tek/
  122.  
  123.     2 copy type_amiga.h over type.h
  124.  
  125.     3 build
  126.  
  127.       - link library, no visuals, with stderr debugging:
  128.         > make -f build/amiga/Makefile_morph_gcc teklib
  129.  
  130.       - link library, no visuals, built from a single file,
  131.         maximum inlining and optimization:
  132.         > make -f build/amiga/Makefile_morph_gcc teklibmonster
  133.  
  134.       - link library including visuals, with stderr debugging:
  135.         > make -f build/amiga/Makefile_morph_gcc teklibvisual
  136.  
  137.       - link library including visuals, built from a single file,
  138.         maximum inlining and optimization:
  139.         > make -f build/amiga/Makefile_morph_gcc teklibvisualmonster
  140.  
  141.     4 build examples with libtek.a. the include directory is
  142.       the parent of tek/. see Makefile_morphos in the examples
  143.       directory for further details.
  144.  
  145.  
  146. AmigaOS 3.x, egcs as cross compiler
  147. -------------------------------------------------------------
  148.  
  149.     1 enter tek/
  150.  
  151.     2 copy type_amiga.h over type.h
  152.  
  153.     3 build 
  154.  
  155.       - link library:
  156.         > make -f build/amiga/Makefile_amiga_gcc teklib
  157.  
  158.       - link library, built from a single file:
  159.         > make -f build/linux/Makefile_amiga_gcc teklibmonster
  160.  
  161.       - link library including visuals:
  162.         > make -f build/linux/Makefile_amiga_gcc teklibvisual
  163.  
  164.       - link library including visuals, built from a single file:
  165.         > make -f build/linux/Makefile_amiga_gcc teklibvisualmonster
  166.  
  167.     4 build examples with libtek.a. the include directory is
  168.       the parent of tek/. see Makefile_amiga_gcc in the examples
  169.       directory for further details.
  170.  
  171.  
  172.  
  173. adjusting debug levels
  174. -------------------------------------------------------------
  175.  
  176.     debug levels can be adjusted in the respective platforms'
  177.     makefiles. see build/<platform>/
  178.     
  179.     debug level 
  180.  
  181.     - 0 indicates no debug info,
  182.     - 1 indicates "maximum",
  183.     - 5 indicates "warning",
  184.     - 10 indicates "error",
  185.     - 20 indicates "failure".
  186.     
  187.     debug levels can be adjusted for individual domains
  188.     of the library:
  189.     
  190.     - KNEXECDEBUG: debug level for the kernel/exec domain,
  191.     - KNSOCKDEBUG: debug level for the kernel/socket domain,
  192.     - KNVISDEBUG: debug level for the kernel/visual domain,
  193.     - TDEBUG: debug level for the tekspace domain.
  194.